home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / findvis.z / findvis
Text File  |  1998-10-20  |  8KB  |  265 lines
  1.  
  2.  
  3.  
  4. ffffiiiinnnnddddvvvviiiissss((((1111GGGG))))                                                        ffffiiiinnnnddddvvvviiiissss((((1111GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      findvis - list OpenGL-capable Visuals meeting selection criteria
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ffffiiiinnnnddddvvvviiiissss [----1111] [----iiiidddd] [----ddddiiiissssppppllllaaaayyyy <display>] [----hhhheeeellllpppp] <specification>...
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _f_i_n_d_v_i_s describes OpenGL-capable X11 Visuals that meet user-specified
  16.      selection criteria.
  17.  
  18.      The options are as follows:
  19.  
  20.           ----1111        List only the first matching Visual, rather than all
  21.                     matching Visuals.
  22.  
  23.           ----iiiidddd       List only the Visual ID of matching Visuals, rather than a
  24.                     one-line description of the Visual.  This is particularly
  25.                     useful in shell scripts, for passing a Visual ID to a
  26.                     program without Visual-selection ability.
  27.  
  28.           ----ddddiiiissssppppllllaaaayyyy  _X_1_1-_d_i_s_p_l_a_y-_n_a_m_e
  29.                     Use the specified X11 display, rather than the default
  30.                     display given by the environment variable DISPLAY.
  31.  
  32.           ----hhhheeeellllpppp     Print a usage summary.
  33.  
  34.      The selection criteria consist of C expressions involving attributes of
  35.      Visuals, plus sort keys that affect the order in which the Visuals will
  36.      be listed.  Several criteria may be passed as a single argument, provided
  37.      they are separated by commas.
  38.  
  39.      Expressions are composed of decimal and hexadecimal constants in the
  40.      usual C notation, plus the following operators with the usual C priority:
  41.  
  42.           || && < <= > >= == != + - * / % ! ( )
  43.  
  44.      and the following variables:
  45.  
  46.           a           Number of bits in the color buffer alpha channel.
  47.  
  48.           accuma      Number of bits in the accumulation buffer alpha channel.
  49.  
  50.           accumb      Number of bits in the accumulation buffer blue channel.
  51.  
  52.           accumg      Number of bits in the accumulation buffer green channel.
  53.  
  54.           accumr      Number of bits in the accumulation buffer red channel.
  55.  
  56.           accumrgb    Minimum of accumr, accumg, and accumb.  (This is usually
  57.                       a more useful summary of accumulation buffer depth than
  58.                       the total number of bits.)
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffiiiinnnnddddvvvviiiissss((((1111GGGG))))                                                        ffffiiiinnnnddddvvvviiiissss((((1111GGGG))))
  71.  
  72.  
  73.  
  74.           accumrgba   Minimum of accumr, accumg, accumb, and accuma.
  75.  
  76.           aux         Number of auxiliary color buffers.
  77.  
  78.           b           Number of bits in the color buffer blue channel.
  79.  
  80.           ci          Number of bits in the color-index buffer.
  81.  
  82.           db          1 if the pixel format is double-buffered, 0 if single-
  83.                       buffered.
  84.  
  85.           g           Number of bits in the color buffer green channel.
  86.  
  87.           id          Under X11, the Visual id of the pixel format.
  88.  
  89.           level       Less than zero for underlay planes, equal to zero for
  90.                       main planes, and greater than zero for overlay planes.
  91.  
  92.           main        1 if the pixel format applies to the main planes, 0 if
  93.                       to underlay or overlay planes.
  94.  
  95.           mono        1 if the pixel format is monoscopic, 0 if stereoscopic.
  96.  
  97.           ms          Number of samples per pixel (for multisample
  98.                       antialiasing).
  99.  
  100.           overlay     1 if the pixel format applies to overlay planes, 0
  101.                       otherwise.
  102.  
  103.           r           Number of bits in the color buffer red channel.
  104.  
  105.           rgb         Minimum of r, g, and b.  (As with accumrgb, this is
  106.                       usually a better summary of color buffer depth than the
  107.                       total number of color bits.)
  108.  
  109.           rgba        Minimum of r, g, b, and a.
  110.  
  111.           s           Number of bits in the stencil buffer.
  112.  
  113.           sb          1 if the pixel format is single-buffered, 0 if double-
  114.                       buffered.
  115.  
  116.           slow        1 if the pixel format has the SLOW caveat (usually
  117.                       meaning it doesn't support hardware acceleration), 0
  118.                       otherwise.
  119.  
  120.           stereo      1 if the pixel format is stereoscopic, 0 if monoscopic.
  121.  
  122.           underlay    1 if the pixel format applies to underlay planes, 0
  123.                       otherwise.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ffffiiiinnnnddddvvvviiiissss((((1111GGGG))))                                                        ffffiiiinnnnddddvvvviiiissss((((1111GGGG))))
  137.  
  138.  
  139.  
  140.           z           Number of bits in the depth (aka ``Z'') buffer.
  141.  
  142.      The operators are applied with normal C syntax and semantics.  Take care
  143.      when using operators (especially ``!'') in expressions, since they are
  144.      metacharacters for most shells.
  145.  
  146.      Sort keys consist of the word min or max followed by one of the variables
  147.      described above.  Visuals with the largest (max) or smallest (min) values
  148.      of the given variable will be listed first.  Whenever a variable is
  149.      specified as a sort key, only Visuals for which the variable is nonzero
  150.      will be considered.  A final sort key of min id is always applied, no
  151.      matter what other sort keys may have been specified, so that Visuals will
  152.      be listed in order of their id numbers when all other keys are equal.
  153.  
  154. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  155.      findvis rgb overlay
  156.           Display all rgb overlay Visuals, if any exist.
  157.  
  158.      findvis 'max ci'
  159.           Display all color-index Visuals, sorted with the deepest Visuals
  160.           first.
  161.  
  162.      findvis -1 -id 'db, max rgb, max z'
  163.           Display the Visual ID of the double-buffered Visual with largest RGB
  164.           and depth buffers.
  165.  
  166.      findvis 'r != g || g != b'
  167.           Display Visuals in which the color channels are not all the same
  168.           size.
  169.  
  170.      findvis 'max rgb, accumrgb >= 2 * rgb'
  171.           Display RGB Visuals that support an accumulation buffer at least
  172.           twice as deep as the main color buffer.
  173.  
  174.      findvis 'id == 0x2c'
  175.           Display the Visual with id 0x2c.
  176.  
  177.      findvis 'rgb, r % 2 || g % 2 || b % 2'
  178.           Display RGB Visuals with at least one odd-sized color channel.
  179.  
  180.      findvis rgba ms s z
  181.           Select multisampled RGBA pixel formats with stencil and depth
  182.           buffers.  The selected pixel formats will be sorted in the default
  183.           order (smallest Visual id first).
  184.  
  185. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  186.      Exit status is 0 if any matching Visuals are found, 1 if no matching
  187.      Visuals are found, and 2 if the specification string is syntactically
  188.      incorrect or if some other exception condition occurs.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ffffiiiinnnnddddvvvviiiissss((((1111GGGG))))                                                        ffffiiiinnnnddddvvvviiiissss((((1111GGGG))))
  203.  
  204.  
  205.  
  206. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  207.      _g_l_x_i_n_f_o(1)
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.